Автор перевода: Майкл "Antares" Клишин	Предыдущая | Следующая | Оглавление

MovieClip.onKeyDown

Доступность

Flash Player 6.

Синтаксис

my_mc.onKeyDown = function() {
  // какой-либо код
}

Параметры

Нет.

Возвращает

Ничего.

Описание

Обработчик события; вызывается, когда мувиклип имеет фокус и нажимается кнопка. Обработчик события onKeyDown вызывается без параметров. Чтобы определить, какая клавиша нажата, используйте методы Key.getAscii() и Key.getCode(). Вы должны определить функцию, исполняемую при вызове обработчика. Вы можете задать эту функцию на Таймлайне, в методе класса, расширяющего класс MovieClip или связанного с символом в Библиотеке. Для более подробной информации смотри "Присваивание класса символу" в Использовании ActionScript во Flash.

Обработчик onKeyDown работает только в том случае, если мувиклип может получать фокус. То есть сначала свойству MovieClip.focusEnabled должно быть присвоено значение true. Затем, мувиклип должен получить фокус. Это может быть достигнуто путем использования Selection.setFocus() или путем обхода по клавише Tab.

При использовании Selection.setFocus(), в качестве параметра Selection.setFocus() должен быть передан путь к мувиклипу. После движения мыши другие элементы легко получают фокус обратно.

Пример

В примере ниже определяется функция-обработчик onKeyDown(), отправляющая при помощи trace() сообщение на панель Output. Создайте мувиклип и назовите его my_mc, затем добавте следующий код во FLA или AS файл:

my_mc.onKeyDown = function() {
  trace("Была нажата клавиша");
};

Мувиклип должен иметь фокус, для того, чтобы обработчик onKeyDown работал. Добавьте подобный код, чтобы присвоить мувиклипу фокус:

my_mc.tabEnabled = true;
my_mc.focusEnabled = true;
Selection.setFocus(my_mc);

Когда мувиклип получает клавиатурный фокус и происходит нажатие клавиши, на панели Output появится надпись Была нажата клавиша. Однако, этого не случится, если двинуть мышь, потому что мувиклип потеряет фокус. Таким образом, Key.onKeyDown следует использовать только в самых необходимых случаях.

См. также

MovieClip.onKeyUp

Посмотреть комментарии LiveDocs		Предыдущая | Следующая | Оглавление